home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / ramail30.zip / RAMAIL.DOC < prev    next >
Text File  |  1991-08-01  |  21KB  |  459 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                      ▒██████ ▒██████ ▒██    ▒██             ▒██
  29.                      ▒██ ▒██ ▒██ ▒██ ▒███  ▒███ ▒█████  ▒██ ▒██
  30.                      ▒██████ ▒██████ ▒████▒████    ▒██      ▒██
  31.                      ▒██ ▒█  ▒██ ▒██ ▒██▒███▒██ ▒█████  ▒██ ▒██
  32.                      ▒██ ▒██ ▒██ ▒██ ▒██ ▒█ ▒██ ▒██▒██  ▒██ ▒██
  33.                      ▒██ ▒██ ▒██ ▒██ ▒██    ▒██ ▒██████ ▒██ ▒██
  34.  
  35.                                    Release 3.0
  36.                       Copyright 1990, 1991 by Randy Blackmond
  37.                                 All Rights Reserved
  38.  
  39.  
  40.      Page 1                                                         RAMail v3.0
  41.      ──────────────────────────────────────────────────────────────────────────
  42.  
  43.      Welcome to RAMail, the mail system exclusively for RemoteAccess!
  44.  
  45.      This version will probably not work with any RA versions prior to 1.01.
  46.  
  47.      FILES INCLUDED IN THE RAMAIL30 ARCHIVE
  48.      ──────────────────────────────────────
  49.      RAMAIL.DOC   - The main documentation (this file)
  50.      RAMCONF.DOC  - The documentation for the config program, RAMCONF.EXE
  51.      RAMUSRED.DOC - The documentation for the RAUSER.DAT editor
  52.      NEWRAU.DOC   - The documentation for the NEWRAU conversion utilities
  53.      NEWRAU18.EXE - The RAUSER.DAT conversion utility for Beta 10 thru 17
  54.      NEWRAU30.EXE - The RAUSER.DAT conversion utility for Beta 18
  55.      RAMAIL.EXE   - The executable door program
  56.      RAMCONF.EXE  - The executable configuration program
  57.      RAMUSRED.EXE - The executable RAUSER.DAT editor
  58.      RAMWELC.ASC  - Sample ASCII welcome file
  59.      RAMWELC.ANS  - Sample ANSI welcome file
  60.      RAMMENU.ASC  - Sample ASCII menu file
  61.      RAMMENU.ANS  - Sample ANSI menu file
  62.      RAMAIL.HLP   - Online Help file
  63.      DOOR.ID      - Door identifier used by SLMR and possibly other readers
  64.      BETATEST.APP - Beta Tester application for future versions of RAMail
  65.  
  66.      THE READER
  67.      ──────────
  68.      The RAMail Door is only half of the complete system. The other half
  69.      is a reader. You, as a sysop, don't need a reader for your door to 
  70.      function, but your users will so they can read and reply to the mail
  71.      in the packets the door produces. I recommend The Silly Little Mail
  72.      Reader, but Session Manager, Qmail or EZ-Reader will also work.
  73.  
  74.      INSTALLATION
  75.      ────────────
  76.      The first thing you need to do is to create a RAMAIL.CFG file by running
  77.      the RAMCONF.EXE program. You must supply the name of the CFG file you wish
  78.      to create/edit on the command line with RAMCONF, e.g. RAMAIL RAMAIL.CFG
  79.      The fields are described in RAMCONF.DOC.
  80.  
  81.      EXTERNAL SUPPORT FILES
  82.      ──────────────────────
  83.      Except where noted, all files listed below use the ASC/ANS extension
  84.      convention for BBS display files and must reside in your RA TextFiles
  85.      directory. All are optional except where noted.
  86.  
  87.      RAMWELC.A*   - This file is displayed to the user upon entering the door.
  88.  
  89.      RANEWUSR.A*  - This file is displayed to a user after the welcome screen
  90.                     the first time he enters the door.
  91.  
  92.      RAMNEWS.A*   - This file is displayed to all users after the opening
  93.                     welcome screen.
  94.  
  95.      RAMMENU.A*   - The RAMail menu. These files are REQUIRED.
  96.  
  97.      RAMAIL.HLP   - This file is REQUIRED and must reside in the same
  98.                     directory as RAMAIL.EXE.
  99.  
  100.  
  101.      Page 2                                                         RAMail v3.0
  102.      ──────────────────────────────────────────────────────────────────────────
  103.  
  104.      HELLO.A*     - This file is included in the users' packets for display
  105.                     by the reader. If not found, your WELCOME.A* file will
  106.                     be used.
  107.  
  108.      INFO.A*      - This file is included in the users' packets for display
  109.                     by the reader. If not found, your NEWS.A* file will be
  110.                     used.
  111.  
  112.      BYE.A*       - This file is included in the users' packets for display
  113.                     by the reader. If not found, your GOODBYE.A* file will
  114.                     be used.
  115.                 
  116.      All external display files used by RAMail support some of the more common
  117.      control codes used by RA. These include clear screen, pause, user name and
  118.      others. Attempts to use an unsupported code will result in N/A being dis-
  119.      played. See RA.DOC for an explanation of these codes.
  120.  
  121.      Code 7 Setup
  122.      ────────────
  123.      Put RAMAIL.EXE, RAMAIL.CFG, RAMAIL.HLP and DOOR.ID in your RA system 
  124.      directory. The menu entry for RAMail should be as follows:
  125.  
  126.      Optional Data: RAMAIL.EXE RAMAIL.CFG *M
  127.  
  128.      You should use RA's swapping to ensure there is enough memory for RAMail
  129.      to run. To do this put *M after RAMAIL.EXE RAMAIL.CFG on your Optional
  130.      Data line. Failure to do so will probably result in not enough memory
  131.      being available for RAMail to run.
  132.  
  133.      Code 15 Setup
  134.      ─────────────
  135.      First, create a directory on your hard drive in which RAMail will reside.
  136.      Place RAMAIL.EXE, RAMAIL.CFG, RAMAIL.HLP and DOOR.ID into that directory.
  137.  
  138.      Create a batch file like the one below:
  139.  
  140.      @echo off
  141.      cd \RA\RAMAIL
  142.      RAMAIL RAMAIL.CFG
  143.      cd \RA
  144.  
  145.      Note that the name of the CFG file you created is passed to RAMAIL.EXE on
  146.      the command line. Also, ANSI.SYS or some facsimile must be loaded to
  147.      enable you to see the ANSI colors the door uses locally. Loading ANSI.SYS
  148.      is not necessary for successful operation of the door, however.
  149.  
  150.      Place the batch file in your RA directory and add the door to your menu
  151.      the same way you add any level 15 door.
  152.  
  153.      There is a file included with the RAMail package named DOOR.ID. This file  
  154.      is used by SLMR to determine which mail door created the packets. Simply
  155.      place the file in the same directory as RAMAIL.EXE and RAMail will include 
  156.      it in all QWK packets automatically.
  157.  
  158.  
  159.      Page 3                                                         RAMail v3.0
  160.      ──────────────────────────────────────────────────────────────────────────
  161.  
  162.      USAGE
  163.      ─────
  164.      The menu for RAMail is straightforward. The options are: Conference
  165.      Select, Download, Upload, File Areas, Page, System Info, Bulletin Toggle,
  166.      Transfer Protocol, Help, New Files, Express Mail Run, Include New Files
  167.      Toggle, ANSI Toggle, Packing Method, Restore Pointers, Modify Pointers,
  168.      Quit and Goodbye.
  169.  
  170.      Conference Selection allows your users to decide which message boards they
  171.      wish to be included in their downloaded mail. It will display all avail-
  172.      able message boards and allow them to pick which ones they want. The con-
  173.      figuration the user chooses will be saved in a mini user file maintained
  174.      by RAMail. They can change their configuration at any time. Users will
  175.      not be allowed to choose boards for which they do not have a high enough
  176.      security level and/or a set Read Flag to read. 
  177.  
  178.      The Download option extracts all new mail for the configuration the user
  179.      has chosen and places them in a compressed packet and then invokes a send
  180.      of the packet. 
  181.  
  182.      The Upload option invokes reception of a reply packet that will be named
  183.      [BBSCODE].REP. It will then uncompress the packet and import the replies
  184.      to your message files where they will be available immediately for 
  185.      reading.
  186.  
  187.      The File Areas option allows users to view your file lists and flag files
  188.      to be downloaded with their mail packet. Checking is done to ensure the
  189.      user has access to a given file area according to security level and flag
  190.      settings. Full support of LIMITS.CTL is provided automatically as well.
  191.      The maximum number of files a user can flag for download is 5. This option
  192.      can be disabled in RAMCONF.
  193.  
  194.      The Page option allows the user to page the Sysop for a chat. This option
  195.      can be disabled in RAMCONF.
  196.  
  197.      The System Info option displays message stats, total calls and last caller
  198.      information. This option can be disabled in RAMCONF.
  199.  
  200.      The Bulletin Toggle allows the user to enable/disable the inclusion of
  201.      new bulletins in his/her mail packet.
  202.  
  203.      The Transfer Protocol option allows the user to select a download protocol
  204.      to be used when performing mail/file transfers. This option is initially
  205.      set to Zmodem for new users.
  206.  
  207.      The Help option will display the file RAMAIL.HLP. You can use the included
  208.      file or create your own. RAMAIL.HLP must reside in the same directory as
  209.      RAMAIL.EXE.
  210.  
  211.      The New Files option will search all available file directories for files
  212.      newer than (or equal to) the date of the user's last call and list them to
  213.      the screen. This option can be disabled in RAMCONF.
  214.  
  215.      The Express Mail Run option will cause RAMail to create the mail packet
  216.      and then immediately send it. Upon completion of the transfer, the user
  217.      will be logged off.
  218.  
  219.  
  220.      Page 4                                                         RAMail v3.0
  221.      ──────────────────────────────────────────────────────────────────────────
  222.  
  223.      The Include New Files Toggle option enables/disables the new files scan
  224.      that RAMail performs during packet creation.
  225.  
  226.      The ANSI Toggle allows the user to turn ANSI off and on. Any change
  227.      made remains effective only while in the RAMail door.
  228.  
  229.      The Packing Method option allows the user to choose which of the 3
  230.      compression methods that you have configured to be used when processing
  231.      mail packets.
  232.  
  233.      The Modify Pointer option allows the user to set ALL Last Read Pointers
  234.      simultaneously to a new value.
  235.      
  236.      The Restore Pointers option restores a user's pointers to the state they
  237.      were in before the user's previous download. Note that if you renumber
  238.      your messages, the saved pointers will then be invalid until the user
  239.      downloads his next packet. The purpose of this option is to allow the
  240.      user to recover from trashed packets due to things such as CRC errors and
  241.      corrupt files.
  242.  
  243.      The Quit option returns the user to the BBS.
  244.  
  245.      The Goodbye option disconnects the caller and exits the door.
  246.      
  247.      Users can select the board configuration they want by entering special 
  248.      offline messages. If a message is addressed to RAMAIL or QMAIL the
  249.      subject will determine the configuration action to be taken. The choices
  250.      for the subject are as follows:
  251.  
  252.      ADD      - Adds a conference and selects all mail
  253.      ADD A    - Adds a conference and selects all mail
  254.      ADD Y    - Adds a conference and selects your mail only
  255.      ADD YA   - Adds a conference and selects your mail and mail to All
  256.      DROP     - Drops a conference
  257.  
  258.      Selecting to receive your own messages can currently only be done online.
  259.  
  260.      Netmail messages can be entered by placing NET> followed immediately by
  261.      the zone:net/node address on the first line of the message, e.g.
  262.  
  263.      NET>1:381/70
  264.  
  265.      The message board that the message is imported to must be a NetMail board.
  266.  
  267.      HISTORY
  268.      ───────
  269.      1.0   Initial release of RAMail!
  270.  
  271.      1.1   Increased the speed of the message export process TREMENDOUSLY!
  272.            200 message packets should be created in about 30 seconds or so.
  273.            Did away with the idea of conference pointers. There's just no
  274.            feasible way to do something like that with RA. The last read
  275.            message pointer will be read from the user's record upon entry
  276.            into RAMail and updated after downloading a packet.
  277.  
  278.      1.2   This version was released as a fix for the problem of the last read
  279.            message pointer not being updated. Too bad it didn't fix it!
  280.  
  281.  
  282.      Page 5                                                         RAMail v3.0
  283.      ──────────────────────────────────────────────────────────────────────────
  284.  
  285.      1.3   Discovered reason for the read pointer not being updated (I thought)
  286.            Added different message download limits for each baud rate (See
  287.            INSTALLATION). Added Hot Keys.
  288.  
  289.      1.4   Finally! An enhancement version! The Configuration option has been
  290.            enhanced to allow the user to elect to receive only their mail and
  291.            mail addressed to All or All mail. Added the Modify Last Read 
  292.            Pointer option. Added optional RACONFS.LST board name file. Last
  293.            Read Message Pointer problem was finally solved!
  294.  
  295.      1.5   Stomped a few more bugs. Added FIDO Default Origin line support for 
  296.            messages uploaded to an EchoMail board. Increased packet processing
  297.            speed even more. RA's message indexes are automatically updated by
  298.            RAMail when replies are uploaded. New RAMCONF program eases creation
  299.            and modification of your RAMAIL.CFG file(s). Added support for
  300.            multiple nodes. RAMail should now work properly on boards where the
  301.            message files reside in their own directory. Much more!
  302.  
  303.      2.0   Still more bugs stomped. Should now be completely FIDO compatible.
  304.            Added Files feature, Your Mail Only mail selector, high ASCII filter
  305.            option for FIDO boards, Personal Mail support, New Files and New
  306.            Bulletins support, Default Protocol, Online Help, Goodbye from the
  307.            menu or after transfer and more!
  308.  
  309.      2.01  Maintenance release. The message attributes set by RAMail were all
  310.            messed up resulting in such problems as imported EchoMail messages
  311.            not being marked as pending export and private messages not being
  312.            marked or recognized as private.
  313.  
  314.      2.1   Added path for RAUSER.DAT in RAMCONF.EXE. This was to allow multiple 
  315.            node systems to use the same RAUSER.DAT file for all nodes. Added
  316.            (S)elect All and (D)eselect All in the configuration option.
  317.  
  318.      2.2   Added support for the DOOR.ID file that SLMR 2.0 will make use of.
  319.            Added offline mail configuration support. RAMail will write to your
  320.            system log(s) when mail/files are download/uploaded. Origin lines
  321.            are attached to incoming echo mail only if Echo Info is enabled in
  322.            your RACONFIG. Stomped a few bugs.
  323.  
  324.      3.0   Netmail support added. Reader taglines in Echomail and Netmail
  325.            boards can be stripped. Several menu options can now be turned off
  326.            if desired. Several external display screens have been implemented.
  327.            Compression/decompression and protocol programs are now fully
  328.            configurable. A new page-oriented conference select screen is now
  329.            used. Users can select to receive their own messages on a per
  330.            conference basis when in C)onference Select. And MORE!
  331.  
  332.      DISCLAIMER
  333.      ──────────
  334.      As stated before, all reasonable precautions have been take to ensure
  335.      that your system files will not be damaged, but if any damage does
  336.      occur caused by RAMail either directly or indirectly, I will not
  337.      be held responsible for such damages. USE THIS PRODUCT AT YOUR OWN RISK!
  338.  
  339.  
  340.      Page 6                                                         RAMail v3.0
  341.      ──────────────────────────────────────────────────────────────────────────
  342.      
  343.      CREDITS
  344.      ───────
  345.      This Door was written with JPDOOR 3.1 Copyright 1991 by Rod Hancock
  346.      PKZIP/PKUNZIP is Copyright 1989-1991 by PKWARE, Inc.
  347.      LHA is Copyright 1988-1991 by Haruyasu Yoshizaki
  348.      ARJ is Copyright 1990, 1991 by Robert K. Jung
  349.      DSZ is Copyright 1991 by Omen Technology INC
  350.      QuickBBS is Copyright 1990 by The QuickBBS Group, Inc.
  351.      RemoteAccess is Copyright 1991 by Continental Software
  352.      Session Manager is copyright 1991 by Patrick Hart
  353.      EZ-Reader is copyright 1988-1991 by Thumper Technologies
  354.      Qmail is copyright 1987-1991 by Sparkware
  355.      Silly Little Mail Reader is copyright 1991 by Greg Hewgill and
  356.                                                    Computer Techniques
  357.  
  358.      And special thanks to the beta testers for their patience, support and
  359.      wonderful suggestions!
  360.  
  361.      PROBLEMS & SUGGESTIONS
  362.      ──────────────────────
  363.      Bug reports, problems, suggestions and comments can be made to Randy
  364.      Blackmond in the RIME/RelayNet Doors, Sysops, Shareware or RA conference,
  365.      The FIDONet Doors, Shareware or RA Utilities echos, NetMail to 1:381/70 or  
  366.      call Randy's Basement BBS 1200/2400/9600 USR DS at (505) 589-0319. I can
  367.      also be reached voice at 505-589-0317. I STRONGLY encourage users to give
  368.      suggestions for new features they would like to see implemented!
  369.  
  370.         COMMON ERROR CODES:
  371.  
  372.         2    File Not Found
  373.                   Check all paths in your RAMail configuration.
  374.  
  375.         3    Path Not Found
  376.                   Check all paths in your RAMail configuration.
  377.  
  378.         100  Disk Read Error
  379.                   This can result if you have an invalid RAUSER.DAT or
  380.                   invalid RAMAIL.CFG file. Delete one or both and start over.
  381.                   Will also occur if you are running a version of RA prior
  382.                   to 1.01. You MUST be running RA 1.01!
  383.  
  384.         101  Disk Write Error
  385.                   Results from a full disk. Free some disk space.
  386.  
  387.         COMMON PROBLEMS AND SOLUTIONS
  388.         ─────────────────────────────
  389.         Problem:  File transfers are always reported as aborted!
  390.         Solution: Set your DSZLOG environment variable (see DSZ.DOC).
  391.  
  392.         Problem:  After an uploaded reply packet has been received, RAMail
  393.                   locks up!
  394.         Solution: You must have your RA environment variable set!
  395.  
  396.  
  397.      Page 7                                                         RAMail v3.0
  398.      ──────────────────────────────────────────────────────────────────────────
  399.  
  400.         Problem:  RAMail does not run on my system AT ALL!
  401.         Solution: You do not have enough memory for RAMail to run in. Add the 
  402.                   *M on your Optional Data line if you are using a type 7 
  403.                   setup. If you are using a type 15 setup and still have this
  404.                   problem, you either have too many TSRs loaded or you are
  405.                   running in too small of a multitasking window.
  406.  
  407.         Problem:  The mail packets are created fine, but when the transfer
  408.                   procedure begins, it always aborts.
  409.         Solution: You probably have an error in your protocol definition in
  410.                   your RAMail configuration. Unless you REALLY know what you
  411.                   are doing, you should use the DSZ defaults provided by
  412.                   RAMCONF.
  413.     
  414.         Problem:  A user who uses Session Manager complains of messages being
  415.                   listed in the wrong conference.
  416.         Solution: Session Manager has some problem with RAMail packets. To
  417.                   resolve it, when loading SM, do it in this manner:
  418.  
  419.                   SM /FI /TC
  420.  
  421.      REGISTRATION
  422.      ────────────
  423.      Usage of the RAMail Door for longer than a 2 week evaluation period
  424.      requires that you register the product with the author. Failure to do
  425.      so violates Federal Copyright Laws and places you in a position to which
  426.      the author can pursue monetary damages in a court of law. Why risk it?
  427.      Register the software. Registration entitles you to free upgrades forever.
  428.  
  429.      To register the RAMail Door, you have two options. 1) Complete the
  430.      following form and mail it back to the author with a check or money order
  431.      made payable to Randy Blackmond for $25.00. 2) Call my board and register
  432.      with your Visa or MasterCard. Your registration number will be left for
  433.      you in a private message on my board. You will need to call and establish
  434.      a user account for this purpose. If you are in FIDONet and accept
  435.      crashmail, I will send the number to you via NetMail.
  436.  
  437.      ──────────────────────────────────────────────────────────────────────────
  438.  
  439.      Randy Blackmond
  440.      RR #1 Box 634                          RAMail 3.0 Door Registration Form
  441.      Anthony, NM 88021
  442.  
  443.      NAME: _______________________________  ADDRESS: ________________________
  444.  
  445.      CITY, STATE, ZIP CODE : ________________________________________________
  446.  
  447.      HOME VOICE PHONE: _____________________ BBS NAME: ______________________
  448.  
  449.      BBS PHONE: _____________________ BAUD RATES SUPPORTED: _________________
  450.  
  451.      ARE YOU IN FIDO? IF SO, YOUR NET/NODE ADDRESS: _________________________
  452.  
  453.      COMMENTS: ______________________________________________________________
  454.  
  455.      ________________________________________________________________________
  456.  
  457.      ________________________________________________________________________
  458.  
  459.